home *** CD-ROM | disk | FTP | other *** search
/ Just Call Me Internet / Just Call Me Internet.iso / com / othernet / mausnet / dot223 / texte / circle.txt < prev    next >
Text File  |  1993-12-02  |  10KB  |  251 lines
  1. Ein blitzkurzer Infotext zu THE_CIRCLE:
  2. =======================================
  3.  
  4. Mit Hilfe von THE_CIRCLE ist es m”glich, im MausTausch-Frontend THE_DOT 
  5. von Jochen Herz (Hi NUNZ!) Serienmails (z.B. fr Einladungen oder sowat) zu 
  6. verschicken. Solche Schreiben nennt man auch Rundschreiben und weil das 
  7. rundeste, was man sich vorstellen kann (von mir abgesehen), ein Kreis ist, 
  8. heižt das Ganze 
  9.  
  10.     THE_CIRCLE.     Schubidu.
  11.  
  12. In THE_DOT wird seit der Version 2.11 eine Schnittstelle zu THE_CIRCLE zur 
  13. Verfgung gestellt: Im Men "Programme" gibt es den Menpunkt "zu CIRCLE...". 
  14. Bei dessen Anwahl wird im MODULE-Ordner nach CIRCLE.PRG gesucht und bei 
  15. Erfolg gestartet. Als Parameter wird der komplette Pfad des momentan in 
  16. THE_DOT eingestellten INF-Files bergeben. Aus diesem entnimmt THE_CIRCLE 
  17. Informationen ber die Message- und Workordner-Struktur.
  18.  
  19. Die vorliegende Version ist inzwischen 1.0 und sie hat weniger Fehler als die
  20. 0.99. Unter Umst„nden kommt es natrlich nach wie vor zu nicht ganz narren- 
  21. sicheren Komfortproblemen und Runtime-Fehlern wegen eventuell nicht gefundener 
  22. Dateien oder Pfade. Da ich's aber trotzdem ver”ffentlicht habe, ist jeder, der 
  23. THE_CIRCLE benutzt, hiermit hochoffziell zum THE_CIRCLE-Tester ernannt.
  24.  
  25.  
  26.  
  27. THE_CIRCLE IST TAFEL_SCHOKOLADE_WARE!
  28.  
  29. Jeder, der's mal benutzt, und dem's gef„llt, nehme eine 200er Briefmarke 
  30. und klebe sie auf eine Tafel Schokolade seiner Wahl. Wenns eine ist, fr 
  31. die man eine 300er Marke braucht, umso besser! Dann noch meine Adresse 
  32. drauf (steht auch in jedem CoNnect-Handbuch):
  33.  
  34.     Philipp Oelwein
  35.     Ringelsgasse 22 a
  36.     69226 Nužloch
  37.  
  38.     Maus: Philipp Oelwein @ HD
  39.           Philipp Oelwein @ LU
  40.  
  41. und in den Briefkasten mit der ganzen Geschichte. Ich versichere hiermit 
  42. meinen ewigen Dank.
  43.  
  44. WARNUNG: Keine Haftung fr Software oder Hardwaresch„den jedweder Art, die
  45.             durch THE_CIRCLE eventuell hervorgerufen wurden! Das Programm 
  46.             arbeitet direkt in der SENDEN-Messagebase, und wenn man groben 
  47.             Unfug baut (man muž sich dafr aber schon sehr anstrengen, mehr 
  48.             dazu siehe unten), ist das SENDEN-Brett nicht mehr lesbar und 
  49.             auch nicht mehr crunchbar. In dem Fall SENDEN.IDX und SENDEN.DBS 
  50.             in den Mlleimer und ausgehende Mail neu schreiben.
  51.  
  52.  
  53. Kurz zur Bedienung:
  54.  
  55. Normalerweise wird man THE_CIRCLE von THE_DOT aus aufrufen (Men "Programme", 
  56. Punkt "Zu CIRCLE...").
  57.  
  58. THE_CIRCLE erwartet, im MODULE-Ordner von THE_DOT zu liegen und versucht, im 
  59. INTERN-Ordner von THE_DOT das THE_DOT-Konfigurationsfile THE_DOT.INF zu laden. 
  60. THE_CIRCLE versucht, seine eigene Resourcedatei im aktuellen Pfad, im 
  61. MODULE-Ordner ind im INTERN-Ordner zu finden und zu laden.
  62.  
  63. Wenn irgendetwas von dieser Ordnerstruktur nicht vorliegen sollte und 
  64. THE_CIRCLE auch mit seinen gewieften und ausgeklgelten Suchroutinen die 
  65. Strukturen auch nirgendwo anders findet - rumms - Runtime Error 2 ;*)
  66.  
  67. THE_CIRCLE kann natrlich auch "stand-alone" gestartet werden. Als Parameter 
  68. kann, wie gesagt ein Pfad eines DOT-INF-Files bergeben werden. Ohne Parameter 
  69. wird als INF-File THE_DOT.INF angenommen. Sollte ein ungltiger Pfad bergeben 
  70. werden, oder sonstwie eine Datei nicht gefunden werden, erscheint eine 
  71. Fileselectorbox, in der man ein INF-File ausw„hlen kann.
  72.  
  73. Wenn aber doch alles da ist, entnimmt THE_CIRCLE daraus, wo sich der Pfad fr
  74. die Dateien SENDEN.DBS und SENDEN.IDX befindet. Dort werden sp„ter die 
  75. Serienmails hingeschrieben. Weiter wird aus dem THE_DOT.INF der jeweilige WORK-
  76. Pfad entnommen. 
  77.  
  78. THE_CIRCLE wird erstmal annehmen, daž sich dort die zwei Dateien mit 
  79.  
  80.     a) dem Serienbrieftext  MAILTEXT.TXT und  
  81.     b) der Empf„ngerliste ADRESSEN.TXT 
  82.  
  83. befinden. Wenn das nicht der Fall sein sollte - auch nicht schlimm, das ist 
  84. einer der F„lle, wo ich den File_Not_Found rechtzeitig abgefangen habe (glaub' 
  85. ich jedenfalls...) und die Dateien, in denen sich diese Infomationen befinden, 
  86. sind ohnehin frei konfigurierbar. Anyway.
  87.  
  88. Nun kommt der Bedienungsdialog auf dem Bildschirm - er besteht aus drei Zeilen 
  89. mit Pfadinformationen und einer Editzeile fr den Betreff der Serienmail.
  90.  
  91. 1. Der Messageordner
  92.         ist der, den THE_CIRCLE aus dem INF-File von THE_DOT erhalten hat und 
  93.         in dem sich die SENDEN-Files befinden sollten. Diese Zeile kann zwar 
  94.         ge„ndert werden, das ist aber ziemlich obsolet - was in THE_DOT.INF 
  95.         steht, muž ja irgendwie schon stimmen, ein Artefakt aus CIRCLE-
  96.         Versionen < 0.35. Vielleicht mach' ich das mal raus.
  97.         
  98.         0.96: Žndern kann man ihn nun nicht mehr, aber er ist noch da...
  99.         
  100.         0.98: Jetzt ist er weg und von den folgenden Numerierungen ist jeweils
  101.               ein Offset von 1 (eins) zu subtrahieren:
  102.  
  103. 2. Der Mailtext
  104.         ist die Datei, deren Inhalt als gleichlautende Mail an alle Empf„nger
  105.         geht. Ein simpler ASCII-Text. Voreingestellt ist WORK\MAILTEXT.TXT, aber 
  106.         die Zeile kann ge„ndert werden, entweder "von Hand" oder durch Mausklick,
  107.         w„hrend man sich mit dem Mauscursor dort befindet. Dann geht ein 
  108.         Fileselector auf, der auf die Extension TXT voreingestellt ist, und mit 
  109.         dem man eben die Textdatei ausw„hlen kann, die als Mail gesendet werden 
  110.         soll. Irgendwelche Platzhalter oder Makros innerhalb des Textes wie 
  111.             
  112.             "Liebe[%Sex] [%Anrede] [%Receiver]! Heute am [%Date] um 
  113.             [%Time] blablabla.."
  114.  
  115.         sind *nicht* vorgesehen! Serienbriefe sollen gleich lauten! Howgh!
  116.  
  117. 3. Die Adrežliste
  118.         ist ebenfalls eine ASCII-Datei, in der pro Zeile ein Empf„nger steht und 
  119.         zwar in einem Format, wie es die MAUS als Empf„ngeradresse verarbeiten
  120.         kann - einfach das gleiche, was man sonst "von Hand" in die Empf„nger-
  121.         zeile eintragen wrde, also zB
  122.         
  123.             Philipp Oelwein @ HD
  124.             Jochen Herz @ LU
  125.             Reiner Juhser @ Fido 2:267/6652.1
  126.             Hans Dampf @ dingsdabox.zer.sub.org
  127.             internet_user@cray1.rechenzentrum.uni-irgendwo.de
  128.         
  129.         Voreingestellt ist ADRESSEN.TXT. Kann genauso ge„ndert werden wie 
  130.         die Datei fr den Mailtext.
  131.         
  132. 4. Die INF-Datei
  133.     ist die THE_DOT-INF-Datei, aus der die Informationen ber die Pfade usw. 
  134.     gelesen werden. Wenn also mit THE_DOT mehrere Netze oder Accounts bedient 
  135.     werden, kann hier eine andere INF-Datei (auf die gleiche Weise wie oben) 
  136.     ausgew„hlt werden, so daž in dem Fall auch auf ein anderes SENDEN-Brett
  137.     zugegriffen wird. Falls das der Fall ist, und in dieser Zeile eine andere 
  138.     INF-Datei ausgew„hlt wurde, sollte in den Zeilen fr die TXT-Dateien 
  139.     auch der entsprechende WORK-Pfad automatisch eingetragen werden. Falls nicht: 
  140.     bitte sofort in ziellose Panik verfallen und mir eine entsprechende Meldung
  141.     zukommen lassen, damit ich ganze N„chte mit dem Debuggen zubringen kann.
  142.     
  143.  
  144. 5. Der Betreff
  145.     Der Text, der in dieses Feld eingetragen wird, wird als Betreff fr die 
  146.     Serienmail verwendet. So einfach ist das. Man kann ihn auch leerlassen, 
  147.     dann nimmt THE_CIRCLE den Text  "Heute kein Betreff" als Betreff.
  148.     
  149.  
  150. Die Execute-Buttons
  151.     Raum und Zeit nochmal, was soll ich da noch erkl„ren???
  152.     
  153.     "Absenden!" sendet und "Abbruch" tut's nicht. Punkt.
  154.  
  155. Links unten ist noch ein bisher disableter Schalter namens "Verteiler" zu 
  156. sehen. In einer sp„teren CIRCLE-Version kann man damit ausw„hlen, ob an jede 
  157. der Serienmails noch eine Liste aller Empf„nger der bewužten Serienmail an-
  158. geh„ngt werden soll.
  159.  
  160.     Momentan noch Einschr„nkungen:
  161.  
  162.         - Betrieb nur fr MAUSnetz
  163.         - L„nge der Serienmail max. 5000 Bytes
  164.         - Keine Erkennung der Plausibilit„t der Adreždatei oder der Mailtext-
  165.           datei. Wenn jemand glaubt, er mžte THE_CIRCLE mal mit TEX.TTP als
  166.           Mailtext und mit CIRCLE.TXT als Adreždatei ausprobieren - viel Spaž!
  167.           Ich bernehme keine Garantie bei Abstrzen und MsgBase-Unf„llen!!
  168.  
  169.  
  170. Viel Spaž also!
  171.  
  172.  
  173.  
  174. Danksagungen:
  175.     
  176.     - Jochen fr THE_DOT
  177.     - Wolfgang fr CoNnect
  178.     - der Gatzweilers Brauerei fr Ihr_wižt_schon_was
  179.     - Mendelssohn fr die Variations serieuses, op. 54
  180.     - Douglas Adams
  181.     
  182.  
  183.  
  184.  
  185. 0.95
  186. ----
  187.     Erste ver”ffentliche Version. Nur noch 5% Fehler drin.
  188.  
  189. 0.96
  190. ----
  191.     Der aktuelle Pfad wird beim Žndern von Mailtext- oder Adreždateien ge„ndert,
  192.     daher wurden relativ gesuchte Dateien (.INF) nicht wiedergefunden.
  193.     
  194.     Die Info-Zeile fr den Message-Ordner ist nun eine reine Anzeige-Zeile und
  195.     nicht mehr zu „ndern.
  196.     
  197.     Nur noch 4% Fehler.
  198.  
  199. 0.97
  200. ----
  201.     An THE_CIRCLE kann als Parameter ein kompletter Pfad eines THE_DOT-INF Files
  202.     bergeben werden. Auf diese Weise kann THE_CIRCLE direkt aus THE_DOT heraus
  203.     aufgerufen und bedient werden. THE_DOT bergibt den Pfad des derzeit einge- 
  204.     stellten INF-Files. Danke, NUNZ!
  205.     
  206.     Diverse "Abbruch"-Auswertungen bei Fileselectorboxen werden jetzt vernnftig
  207.     abgefangen. Wahrscheinlich aber immer noch nicht alle.
  208.     
  209.     Nach Umherschalten des aktuellen Pfades wird dieser bei Programmende wieder 
  210.     auf "den alten Stand gebracht".
  211.     
  212.     Restfehler: 3%
  213.     
  214. 0.98
  215. ----
  216.     THE_CIRCLE sucht seine Resourcedatei jetzt im aktuellen Pfad, im MODULE- 
  217.     und im INTERN-Ordner von THE_DOT.
  218.     
  219.     Fehlerhafte INF-Dateipfade werden nicht mehr durch einen Runtime Error 2, 
  220.     sondern durch eine Fileselectorbox abgefangen, in der ein INF-File bestimmt 
  221.     werden kann.
  222.     
  223.     Und nur noch 2% Fehler!
  224.     
  225. 0.99
  226. ----
  227.     Die Fileselectbox bei fehlerhaftem INF-Pfad bekommt man nun solange 
  228.     pr„sentiert, bis man Abbruch w„hlt oder eine existierende INF-Datei.
  229.     Daž das auch wirklich eine THE_DOT-INF-Datei ist, darauf sollte man aber 
  230.     schon selbst achten!
  231.     
  232.     Yupiie! Nur noch 1% Fehler! Das sind immernoch 121 Bytes... Mal sehen, 
  233.     ob ich die nicht noch finden kann.
  234.     
  235. 1.00
  236. ----
  237.     Fr die Pfade stehen jetzt 10 Zeichen mehr zur Verfgung. (Fr die Leute,
  238.     die ihre DOT-Ordnerstruktur „hnlich tief geschachtelt haben wie ich.)
  239.     
  240.     Und Fehler sind jetzt auch keine mehr drin. Jedenfalls weniger als Epsilon.
  241.     
  242.     Also ab in die Boxen damit.
  243.     
  244.     
  245.     
  246. Geplant:
  247. --------
  248.     - Plausibilit„tsprfung fr Mailtext- und Adreždatei
  249.     - Plausibilit„tsprfung fr ausgew„hlte INF-Datei
  250.     - Verteiler (alle Empf„nger) in die Mail bernehmen
  251.